Skip to content

Conversation

@ddbeck
Copy link
Contributor

@ddbeck ddbeck commented Jan 13, 2026

Summary

Consumers of BCD probably shouldn't use the experimental field.

Test results and supporting details

In the October 21, 2025 BCD meeting, I suggested this as a possibility. I'm finally getting around to it!

Related issues

n/a

@ddbeck ddbeck requested a review from a team as a code owner January 13, 2026 17:24
@github-actions github-actions bot added schema Isses or pull requests regarding the JSON schema files used in this project. docs Issues or pull requests regarding the documentation of this project. size:xs [PR only] 0-6 LoC changed labels Jan 13, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 13, 2026

Tip: Review these changes grouped by change (recommended for most PRs), or grouped by feature (for large PRs).


- `experimental`: a `boolean` value.

**Warning**: The `experimental` property is deprecated. Prefer using more well-defined stability calculations, such as Baseline, instead.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**Warning**: The `experimental` property is deprecated. Prefer using more well-defined stability calculations, such as Baseline, instead.
> [!WARNING]
> The `experimental` property is **deprecated**.
> Prefer using better defined stability calculations, such as Baseline, instead.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unfortunately, this won't work. GitHub's (non-standard, unspecified 🙄) admonitions don't work in a list. They only render if the > is at column 1.

ddbeck and others added 2 commits January 13, 2026 18:55
@github-actions github-actions bot added size:s [PR only] 7-24 LoC changed and removed size:xs [PR only] 0-6 LoC changed labels Jan 13, 2026
Copy link
Contributor

@foolip foolip left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm excited for this!

@caugner
Copy link
Contributor

caugner commented Jan 14, 2026

Consumers of BCD probably shouldn't use the experimental field.

BCD tables on MDN show an icon for experimental features. We could instead show a Baseline icon, but we would probably have to compute it directly from each BCD feature, without taking into consideration web-features.

I would propose to add this computed Baseline status per BCD feature into the published BCD data, and to do this at the same time of deprecating experimental.

Copy link
Contributor

@caugner caugner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should wait with the deprecation until we provide a per-feature replacement of the experimental status, see my previous comment.

@ddbeck
Copy link
Contributor Author

ddbeck commented Jan 15, 2026

I don't think we should wait. This advice would be to new consumers of BCD: they should not use experimental for any purpose. But existing consumers of BCD may (at least until there's a plan to remove experimental).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Issues or pull requests regarding the documentation of this project. schema Isses or pull requests regarding the JSON schema files used in this project. size:s [PR only] 7-24 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants